<!DOCTYPE html>
<html>
  <head>
    <meta name="creator" content="mantohtml v2.0.2">
    <title>cancel(1)</title>
  </head>
  <body>
    <h1 id="cancel-1">cancel(1)</h1>
    <h2 id="cancel-1.name">Name</h2>
<p>cancel - cancel jobs
</p>
    <h2 id="cancel-1.synopsis">Synopsis</h2>
<p><strong>cancel</strong>
[
<strong>-h</strong>
<em>hostname[:port]</em>
] [
<strong>-E</strong>
] [
<strong>-U</strong>
<em>username</em>
] [
<strong>-a</strong>
] [
<strong>-u</strong>
<em>username</em>
] [
<strong>-x</strong>
] [
<em>id</em>
] [
<em>destination</em>
] [
<em>destination-id</em>
]
</p>
    <h2 id="cancel-1.description">Description</h2>
<p>The <strong>cancel</strong> command cancels print jobs.
If no <em>destination</em> or <em>id</em> is specified, the currently printing job on the default destination is canceled.
</p>
    <h2 id="cancel-1.options">Options</h2>
<p>The following options are recognized by <strong>cancel</strong>:
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a</strong><br>
Cancel all jobs on the named destination, or all jobs on all destinations if none is provided.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
Forces encryption when connecting to the server.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>hostname</em>[<em>:port</em>]<br>
Specifies an alternate server.
Note: This option must occur before all others.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
Specifies the username to use when connecting to the server.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u </strong><em>username</em><br>
Cancels jobs owned by <em>username</em>.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-x</strong><br>
Deletes job data files in addition to canceling.
</p>
    <h2 id="cancel-1.conforming-to">Conforming To</h2>
<p>Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, &quot;/&quot;, or &quot;#&quot;. Also, printer and class names are <em>not</em> case-sensitive.
</p>
    <h2 id="cancel-1.examples">Examples</h2>
<p>Cancel the current print job:
</p>
    <pre>
    cancel

</pre>
<p>Cancel job &quot;myprinter-42&quot;:
</p>
    <pre>
    cancel myprinter-42

</pre>
<p>Cancel all jobs:
</p>
    <pre>
    cancel -a
</pre>
    <h2 id="cancel-1.notes">Notes</h2>
<p>The
<strong>-a</strong>
and
<strong>-u</strong><em> username</em>

options require administrative access.
These restrictions are part of the operation policies defined in the
<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5)</a>

file for the &quot;Cancel-Jobs&quot; and &quot;Cancel-My-Jobs&quot; operations, respectively.
</p>
    <h2 id="cancel-1.see-also">See Also</h2>
<a href="cupsd.conf.html"><p><strong>cupsd.conf</strong>(5),</a>

<a href="lp.html"><strong>lp</strong>(1),</a>

<a href="lpmove.html"><strong>lpmove</strong>(8),</a>

<a href="lpstat.html"><strong>lpstat</strong>(1),</a>

CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
    <h2 id="cancel-1.copyright">Copyright</h2>
<p>Copyright &copy; 2020-2024 by OpenPrinting.
  </body>
</html>
